home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / datatypes / sun.datatype / sun.datatype.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  10KB  |  196 lines
  1. @DATABASE "sun.datatype.guide"
  2. @$VER: sun.datatype.guide 39.6 (22.1.95)
  3. @AUTHOR "Arthur Pijpers"
  4. @NODE Main "sun.datatype Documentation"
  5. @{B}Table of Contents@{UB}
  6. @{" Introduction                           " link Introduction}
  7. @{" Requirements                           " link Requirements}
  8. @{" How to Install                         " link Installation}
  9. @{" What is a Sun Raster file ?            " link Sun }
  10. @{" What is a datatype?                    " link Datatypes}
  11. @{" Implementation Details (Release Notes) " link Implementation}
  12. @{" Revision history                       " link History}
  13. @{" Acknowledgements                       " link Acknowledgements}
  14. @{" Author                                 " link Author}
  15. @ENDNODE
  16. @NODE Introduction
  17. @{B}Introduction@{UB}
  18. This is V39.6 of the @{"Sun" link Sun} @{"datatype" link Datatypes}. The version information can be verified
  19. by using the AmigaDOS @{B}version@{UB} command on the datatype file
  20. SYS:classes/datatypes/sun.datatype after installation.
  21. Once installed, the Sun datatype means that any datatype-aware programs can
  22. read @{"Sun Raster" link Sun} image files.
  23. Examples of this are that a Sun image can be used as a Workbench screen
  24. backdrop, and Multiview can be used to display them.
  25. The Sun datatype is freely distributable, but you may not charge for it,
  26. other than for reasonable media and distribution costs such as those charged
  27. by Fred Fish and other reputable PD libraries.
  28. The Sun datatype can be distributed as part of a datatype collection, but
  29. then you have to supply both the 68000 and the 68020 version.
  30. @ENDNODE
  31. @NODE Requirements
  32. @{B}Requirements@{UB}
  33. Datatypes were introduced with Workbench 3.0, so the main requirement is
  34. that you have this version of the OS. Presumably, any future versions of the
  35. OS will also support them.
  36. Do not try to install the datatype if you are using an OS older than 3.0
  37. (i.e. 1.3, 2.04, or 2.1).  The correct directories do not exist, and nothing
  38. will work even if you create them.  I'm afraid you'll have to find some
  39. other program to view your @{"Sun Raster" link Sun} files with.
  40. When you use the datatype on a computer without the AGA chipset, then 
  41. pictures with more than 16 colours hires or 32 colours lores are
  42. automatically dithered to the maximum number of available colours, unless
  43. you have a graphical card added.
  44. 24 Bit pictures need AGA chips (or AGA-emulation) to be displayed correctly.
  45. @ENDNODE
  46. @NODE Installation
  47. @{B}How to Install@{UB}
  48. Installation can be done in one of two ways:
  49. 1) Using Installer
  50. 2) Manual Installation
  51. If you have a copy of Installer, you can simply double click on the
  52. sun.datatype.install icon and follow the onscreen instructions. The
  53. Installer script follows the manual sequence below, so you are advised to
  54. read it quickly so that you know what to expect.
  55. If you do not have Installer, (which is strange, because you have
  56. Workbench 3), then follow the procedure below:
  57. 1) Copy the file sun.datatype.68000 or sun.datatype.68020 to the directory
  58. SYS:classes/datatypes and rename it to sun.datatype (SYS: is a logical name
  59. for the disk you boot from).  You can perform the copy either from the
  60. Workbench or the Shell. Use the 68020 version only on Amigas with a 68020
  61. processor or higher.
  62. 2) Decide whether you want the datatype to be permanently enabled, or
  63. manually run whenever you want to use it.  Proceed to step 3 for a
  64. permanently enabled installation, otherwise proceed to step 4.
  65. 3) Copy the file "Sun Raster" to the directory DEVS:Datatypes (DEVS: is a
  66. logical directory on the disk you boot from.  It is the same as the DEVS
  67. drawer on the boot disk).  If using the Shell, you will also have to
  68. manually copy the icon file "Sun Raster.info".  When you reboot your system,
  69. the Sun datatype will be avaliable for use.
  70. 4) Copy the file "Sun Raster" to the directory SYS:Storage/Datatypes. If
  71. using the Shell, you will also have to manually copy the icon file
  72. "Sun Raster.info".
  73. The Sun datatype will not be available until you double click on the
  74. "Sun Raster" icon, at which point it will remain installed until a reboot.
  75. If you already had an older version of the sun.datatype, then you can remove
  76. the files Sun and Sun.info from the DEVS:DataTypes directory.
  77. This completes installation.
  78. @ENDNODE
  79. @NODE Sun
  80. @{B}What is a Sun Raster file ?@{UB}
  81. A Sun Raster file is a file of an image, used on Sun computers. The files
  82. can be compressed or uncompressed, just like IFF ILBM files. It looks much
  83. like an IFF file, but compression is a little different and also less
  84. efficient than IFF compression.
  85. @ENDNODE
  86. @NODE Datatypes
  87. @{B}What is a Datatype?@{UB}
  88. Datatypes were introduced with Workbench 3.0, and provide a way for
  89. applications to read data files without having to learn all the messy
  90. details about how the data in the files are stored.
  91. As an example, consider storing pictures on computer.  As Amiga owners, we
  92. are relatively lucky in that all images are stored using the IFF ILBM
  93. format.  Other computers have a bewildering array of incompatible formats,
  94. and there exist commercial packages with the sole purpose of converting
  95. images between them.
  96. If I wanted to write a paint program, it would certainly be more useful if
  97. it could read and maybe write out images in some of these other formats.
  98. However, implementing such feature would be a bit of a nightmare, as I would
  99. have to obtain the specifications of these formats, plus some test images,
  100. and write (and support) a significant amount of code to read and write these
  101. various formats.
  102. A datatype is a little program that performs this conversion for me, and
  103. completely hides all the messy implementation details about what file
  104. headers exist, how they are structured, etc.  My application can open the
  105. datatypes library, pass a file to it and ask if it recognises the format.
  106. The datatypes library has a look at the file, and then consults its list of
  107. installed datatypes to see if any of them recognise it.  It then comes back
  108. to the application with a reply saying "Yup, its a Sun picture".
  109. My application can then ask for the data to be read in, and after a short
  110. while the library will return the information in an Amiga standard format,
  111. in this case, an IFF image.  Of course, someone has to write the datatype,
  112. but once written and installed, any other program that uses datatypes can
  113. take advantage of it at no extra cost or expense.
  114. This datatype decodes Sun images, and any application that wishes to read
  115. this format of images can do so without having to know anything about them.
  116. @ENDNODE
  117. @NODE Implementation
  118. @{B}Implementation Details (Release Notes)@{UB}
  119. These are the release notes for V39.6 of the Sun datatype.
  120. This implementation will decode @{"Sun Raster" link Sun} files in up to 256 colours.
  121. 24 Bit Sun Raster images are converted to HAM8. Only standard and byte-
  122. encoded files are handled. If a colourmap is supplied then it needs to be in
  123. equal RGB format.
  124. If you are using Multiview to display @{"Sun Raster" link Sun} files without
  125. the SCREEN tooltype/parameter, the @{"Sun Raster" link Sun} file will be
  126. displayed in a window on the Workbench, it will be quantised down to however
  127. many colours you have set up on your Workbench screen. 24 Bit pictures are
  128. always shown on a separate HAM8 screen.
  129. If you are using Multiview with the SCREEN tooltype/parameter, the datatype
  130. will choose the screen resolution that it thinks is most appropriate for
  131. displaying the image from the selection available in the display database.
  132. This decision is made using the BestModeID function, and is based on the
  133. size, colour count and aspect ratio of the image. I am not really satisfied
  134. with the results from BestModeID, but I haven't found a better way yet.
  135. When you display a picture of 1152 * 900 * 256 colours, which is a standard
  136. Sun format, then the image doesn't appear when showing on the Workbench
  137. screen. This is a memory problem, that is probably produced by the
  138. picture.datatype. If the picture doesn't appear, then try to display the
  139. picture on a separate screen. This will probably work better. 
  140. @ENDNODE
  141. @NODE History
  142. @{B}Revision History@{UB}
  143. Version 39.1 released 11-12-1993
  144.  - First release
  145. Version 39.2 released 12-12-1993
  146.  - Bug fixed, for colourmaps with less than 2^depth colours.   
  147. Version 39.3 released 15-2-1994
  148.  - Major bug fix. Compressed pictures using colour 0x80 were displayed
  149.    wrong. I finally had some Sun images to test it.
  150.  - Removed some unused structure members
  151.  - Colourmap reading speed improved
  152.  - Used SAS-C V6.51 to compile
  153.  - Added 68000 version of the datatype, for people who updated their
  154.    Amiga 500, 500+, 600, 2000 or 2500 to Kickstart 3.
  155. Version 39.4 released 13-3-1994
  156.  - Uses less memory. If the file can't be read in 1 part, it will be read
  157.    in smaller parts, requiring less memory
  158.  - NTSC and PAL screens are promoted to DBLNTSC and DBLPAL if available.
  159.    BestModeID doesn't seem to do this always
  160.  - Added support for 24 bit images. These images are converted to HAM8, 
  161.    using a standard internal palette. No support for 24 bit cards yet
  162.  - Changed the datatype description file from SUN to SUN Raster
  163.  - Sources included
  164. Version 39.5 released 6-9-1994
  165.  - Bug fixed, black & white pictures were displayed wrong.
  166.  - Changed datatype description file from 'SUN Raster' to 'Sun Raster'
  167.    to keep the same name convention as the Commodore 'Sun Audio' datatype.
  168. Version 39.6 released 23-1-1995
  169.  - Replaced Chunky2planar and RGBtoHAM8 routines by assembler routines, made
  170.    by John Hendrikx
  171. @ENDNODE
  172. @NODE Acknowledgements
  173. @{B}Acknowledgements@{UB}
  174. Sun datatype is based on the BMP datatype.
  175. This AmigaGuide
  176.  file and the Installer script have been copied from the
  177. JPEG.datatype by Steve Goddard and have been adapted to the Sun datatype.
  178. The code for the 24 bit to HAM8 conversion is based on Display24.c from
  179. Michael Saunby.
  180. Thanks to John Hendrikx (TextDemo/FastView) for the Chunky2planar and
  181. RGBtoHAM8 routines.
  182. Sun datatype was compiled using SAS/C V6.51
  183. @ENDNODE
  184. @NODE Author
  185. @{B}Author@{UB}
  186. Please feel free to contact me at:
  187. Arthur Pijpers
  188. 2e Scheepvaartstraat 24
  189. 3151 NP Hoek van Holland
  190. Holland
  191. Usenet  : arthurp@grafix.xs4all.nl
  192. FidoNet :  2:286/407.37
  193. AMYNet  : 39:153/201.37
  194. NLANet  : 14:101/200.37
  195. @ENDNODE
  196.